home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / dsm.z / dsm
Encoding:
Text File  |  2002-10-03  |  7.2 KB  |  120 lines
  1. DSM(3I)                                               Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      DDSSMM__CCHHUUNNKKSSIIZZEE, DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__BBLLOOCCKK, DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__CCYYCCLLIICC,
  6.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__SSTTAARR, DDSSMM__IISSDDIISSTTRRIIBBUUTTEEDD, DDSSMM__IISSRREESSHHAAPPEEDD,
  7.      DDSSMM__NNUUMMCCHHUUNNKKSS, DDSSMM__NNUUMMTTHHRREEAADDSS, DDSSMM__RREEMM__CCHHUUNNKKSSIIZZEE, DDSSMM__TTHHIISS__CCHHUUNNKKSSIIZZEE,
  8.      DDSSMM__TTHHIISS__SSTTAARRTTIINNGGIINNDDEEXX, DDSSMM__TTHHIISS__TTHHRREEAADDNNUUMM - Query intrinsics for
  9.      distributed arrays
  10.  
  11. SSYYNNOOPPSSIISS
  12.      DDSSMM__CCHHUUNNKKSSIIZZEE (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m))
  13.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__BBLLOOCCKK (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m))
  14.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__CCYYCCLLIICC (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m))
  15.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__SSTTAARR (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m))
  16.      DDSSMM__IISSDDIISSTTRRIIBBUUTTEEDD (([AARRRRAAYY==]_a_r_r_a_y))
  17.      DDSSMM__IISSRREESSHHAAPPEEDD (([AARRRRAAYY==]_a_r_r_a_y))
  18.      DDSSMM__NNUUMMCCHHUUNNKKSS (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m))
  19.      DDSSMM__NNUUMMTTHHRREEAADDSS (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m))
  20.      DDSSMM__RREEMM__CCHHUUNNKKSSIIZZEE (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m,, [IINNDDEEXX==]_i_n_d_e_x))
  21.      DDSSMM__TTHHIISS__CCHHUUNNKKSSIIZZEE (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m,, [IINNDDEEXX==]_i_n_d_e_x))
  22.      DDSSMM__TTHHIISS__SSTTAARRTTIINNGGIINNDDEEXX (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m,, [IINNDDEEXX==]_i_n_d_e_x))
  23.      DDSSMM__TTHHIISS__TTHHRREEAADDNNUUMM (([AARRRRAAYY==]_a_r_r_a_y,, [DDIIMM==]_d_i_m,, [IINNDDEEXX==]_i_n_d_e_x))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28.      MIPSpro 7 Fortran 90, MIPSpro Fortran 77
  29.  
  30. SSTTAANNDDAARRDDSS
  31.      Fortran extension
  32.  
  33. DDEESSCCRRIIPPTTIIOONN
  34.      You can use the Dynamic Shared Memory (DSM) functions to obtain
  35.      information about an individual dimension of a distributed array.  All
  36.      functions work with 64-bit integers.
  37.  
  38.      The DSM functions are as follows:
  39.  
  40.      FFuunnccttiioonn            PPuurrppoossee
  41.  
  42.      DDSSMM__CCHHUUNNKKSSIIZZEE       Returns the chunk size (ignoring partial chunks)
  43.                          in the given dimension for each of BBLLOOCCKK, CCYYCCLLIICC,
  44.                          and asterisk (**) distributions.
  45.  
  46.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__BBLLOOCCKK
  47.                          Returns 00 (FFAALLSSEE) or 11 (TTRRUUEE) for a query on
  48.                          whether or not the specified dimension has a BBLLOOCCKK
  49.                          distribution.
  50.  
  51.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__CCYYCCLLIICC
  52.                          Returns 00 (FFAALLSSEE) or 11 (TTRRUUEE) for a query on
  53.                          whether or not the specified dimension has a
  54.                          CCYYCCLLIICC distribution.
  55.  
  56.      DDSSMM__DDIISSTTRRIIBBUUTTIIOONN__SSTTAARR
  57.                          Returns 00 (FFAALLSSEE) or 11 (TTRRUUEE) for a query on
  58.                          whether or not the specified dimension has an
  59.                          asterisk (**) distribution.
  60.  
  61.      DDSSMM__IISSDDIISSTTRRIIBBUUTTEEDD   Returns 00 (FFAALLSSEE) or 11 (TTRRUUEE) for a query on
  62.                          whether or not array is distributed (regular or
  63.                          reshaped) or not.
  64.  
  65.      DDSSMM__IISSRREESSHHAAPPEEDD      Returns 00 (FFAALLSSEE) or 11 (TTRRUUEE) for a query on
  66.                          whether or not array is reshaped or not.
  67.  
  68.      DDSSMM__NNUUMMCCHHUUNNKKSS       Returns the number of chunks (including partial
  69.                          chunks) in the given _d_i_m for each of BBLLOOCCKK,
  70.                          CCYYCCLLIICC, and asterisk (**) distributions.
  71.  
  72.      DDSSMM__NNUUMMTTHHRREEAADDSS      Returns the number of threads in the specified
  73.                          dimension of a distributed array.
  74.  
  75.      DDSSMM__RREEMM__CCHHUUNNKKSSIIZZEE   Returns the remaining chunk size from _i_n_d_e_x to the
  76.                          end of the current chunk, inclusive of each end
  77.                          point.  Essentially it is the distance from _i_n_d_e_x
  78.                          to the end of that contiguous block, inclusive.
  79.  
  80.      DDSSMM__TTHHIISS__CCHHUUNNKKSSIIZZEE  Returns the chunk size for the chunk containing
  81.                          the specified _i_n_d_e_x for each of BBLLOOCCKK, CCYYCCLLIICC, and
  82.                          asterisk (**).  This value may be different from
  83.                          DDSSMM__CCHHUUNNKKSSIIZZEE due to edge effects that can lead to
  84.                          a partial chunk.
  85.  
  86.      DDSSMM__TTHHIISS__SSTTAARRTTIINNGGIINNDDEEXX
  87.                          Returns the starting index value of the chunk
  88.                          containing the supplied _i_n_d_e_x.
  89.  
  90.      DDSSMM__TTHHIISS__TTHHRREEAADDNNUUMM  Returns the thread number for the chunk containing
  91.                          the given index value for each of BBLLOOCCKK, CCYYCCLLIICC,
  92.                          and asterisk (**) distributions.
  93.  
  94.      These functions accept the following arguments:
  95.  
  96.      _a_r_r_a_y     An array of any data type.
  97.  
  98.      _d_i_m       The array dimension for which you need information.  The
  99.                array dimensions are numbered starting at 1.  Must be of
  100.                type integer.
  101.  
  102.      _i_n_d_e_x     Must be of type integer.
  103.  
  104.      The names of these intrinsics cannot be passed as arguments.
  105.  
  106. RREETTUURRNN VVAALLUUEESS
  107.      The return value is of type integer.  If you are using the MIPSpro 7
  108.      Fortran 90 compiler, the value is IINNTTEEGGEERR((KKIINNDD==88)).
  109.  
  110.      These functions return --11 in case of an error.  For
  111.      DDSSMM__TTHHIISS__SSTTAARRTTIINNGGIINNDDEEXX, however, --11 can be a valid return value.
  112.  
  113. SSEEEE AALLSSOO
  114.      _M_I_P_S_p_r_o _7 _F_o_r_t_r_a_n _9_0 _C_o_m_m_a_n_d_s _a_n_d _D_i_r_e_c_t_i_v_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l
  115.  
  116.      mmpp(3F)
  117.  
  118.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  119.      man page.
  120.